home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / MSDOS / (m)aaj / SP.DOC < prev    next >
Text File  |  1984-06-27  |  10KB  |  286 lines
  1.  
  2.                         SP: A PRINT SPOOLER
  3.                     for the IBM Personal Computer
  4.                             Version 3.79
  5.  
  6.                       Copyright Alan Jones 1983
  7.                          3717 Wildwood Drive
  8.                           Endwell, NY 13760
  9.                            (607) 754-2339
  10.                            June 27, 1984
  11.  
  12.  
  13.  
  14. SP is a software printer buffer to hold data intended for the printer.
  15. It works like the buffers that can be installed in the printer but the
  16. data is stored in RAM storage instead of in the printer.  The buffer
  17. is unloaded to the printer at the printer's speed while DOS proceeds
  18. at its speed.  The size of the buffer is specified as a parameter when
  19. SP is invoked.  For example,
  20.  
  21.             SP 14
  22.  
  23. will produce a buffer of 14KB (1KB = 1024 bytes).
  24.  
  25. The complete syntax is:
  26.  
  27.      SP [ss] [C=cc] [P=pp]
  28.  
  29. where:
  30.  
  31.         ss: size of buffer in kilobytes.  One kilobyte = 1024 bytes.
  32.             Maximum size is 62 KB.
  33.  
  34.         cc: number of copies desired.  Default: 1.
  35.  
  36.         pp: printer port desired (1, 2, or 3).  Default: 1.
  37.  
  38. NOTE:  You do not type the square brackets.  They merely indicate that the
  39. contents are optional.  For example, if you want to use printer port 2 with
  40. a buffer size of 20 KB, you would enter:
  41.  
  42.         SP 20 P=2
  43.  
  44. If you want to keep the previous buffer and only change the number of
  45. copies to 3 copies, enter:
  46.  
  47.         SP C=3
  48.  
  49. For the "C" and "P" you can enter either upper or lower case characters.
  50.  
  51. If the size parameter is omitted, a default buffer of 16KB is used.
  52.  
  53. The program will work for all work sent to the printer whether it is from
  54. the DOS TYPE command, a PrtSc command, a BASIC LLIST or LPRINT command, a
  55. print command from The Personal Editor, etc.
  56.  
  57.  
  58. TO STOP PRINTING
  59.  
  60. If you start a printout and decide you don't want it, press,
  61. simultaneously, Alt-LeftShift-PrtSc to flush the buffer.  You can also
  62. flush the buffer by turning the printer off and then back on.
  63.  
  64.  
  65.  
  66. TO PAUSE
  67.  
  68. If you want the printing to pause, hold down the ON LINE button until the
  69. printer stops (which it will do at the end of a line).  Pressing the ON
  70. LINE button again will allow printing to resume with no loss of data.
  71.  
  72.  
  73. CHANGING BUFFER SIZE
  74.  
  75. You can remove SP from the machine by specifying a buffer of zero.  That
  76. is:
  77.  
  78.       SP 0
  79.  
  80.  
  81. will return DOS to its original state unless another DOS extension is
  82. installed after SP.  You can then re-install SP at the new size, for
  83. example:
  84.  
  85.       SP 45
  86.  
  87.  
  88.  
  89. MULTIPLE COPIES
  90.  
  91. To create multiple copies of a document, you must indicate to SP where the
  92. beginning and end of the document is.  To indicate the beginning of a
  93. document press Alt-LeftShift-B.  To indicate the end of a document press
  94. Alt-LeftShift-E.  Of course, if you have indicated only one copy, that is
  95. all you will get.  You can press the END indication when SP has gobbled up
  96. the text.  You don't have to wait until the first copy is printed.
  97.  
  98. One nice way of using the multiple copies is after the fact.  That is, if
  99. you just printed a document and decide you'd like another copy, from DOS
  100. indicate the TOTAL number of copies you want (2 or more) and then invoke
  101. the END indication.  SP will determine that one copy has already been
  102. printed and proceed to print the rest according to the quantity specified.
  103.  
  104. You have to be a bit careful.  Once you indicate the beginning of a
  105. document (Alt-LeftShift-B) that remains the beginning until you change it.
  106. If you print multiple copies of something and then send something else to
  107. the printer and again indicate the END, you will get a document from the
  108. most recent BEGIN.  This may or may not be what you want.
  109.  
  110.  
  111. MULTIPLE PRINTERS
  112.  
  113. SP can support more than one printer.  When you invoke SP it creates a
  114. buffer for the specified printer.  If you do not specify one, it will
  115. create a buffer for LPT1.  You can then re-invoke SP specifying another
  116. printer and a new buffer will be created.  From then on, the data going to
  117. the printer will enter the appropriate buffer and be printed on the
  118. appropriate printer.  When you give keyboard commands, SP does not know
  119. which printer to which they apply so it uses them for all.  That is, if you
  120. flush the buffer (Alt-LeftShift-PrtSc), all buffers will be flushed.  If
  121. you indicate the end of a document, this will apply to all buffers.
  122.  
  123.  
  124.  
  125. CAVEATS:
  126.  
  127. When using SP in some environments, such as with a word processor, there
  128. may be commands that allow you to stop the printer.  However, when SP is
  129. present, the program will be way ahead of the printer and will only stop
  130. sending data to the buffer.  In cases like this, turn off the printer and
  131. then turn back on again to stop printing.
  132.  
  133.  
  134. OPERATING ENVIRONMENTS
  135.  
  136. SP has been tested in the following environments:
  137.  
  138.    PrtSc command                   WordStar
  139.    DOS TYPE to printer             EasyWriter 1.1
  140.    BASIC LLIST                     VisiCalc
  141.    BASIC LPRINT                    With Communications
  142.    BASIC PRINT#                    The Personal Editor
  143.    Lotus 1-2-3                     Multiplan
  144.    PC-FILE                         PC-TALK
  145.  
  146. And with many, many printers on the parallel port.  Note, SP will not work
  147. properly with a printer on the communications (serial) port.
  148.  
  149.  
  150.  
  151. AVAILABILITY
  152.  
  153. Available from Alan Jones under the "user supported software" concept.
  154. See below.
  155.  
  156. COPYING
  157.  
  158. SP can be copied onto one of your own diskettes for use on your machine.
  159. In fact we recommend including it in your AUTOEXEC so that it is always
  160. invoked.
  161.  
  162. DISCLAIMER.
  163.  
  164. In no event will the Author be liable to you for any damages, including any
  165. lost profits, lost savings or other incidental or consequential damages
  166. arising out of the use of or inability to use these programs, even if the
  167. Author has been advised of the possibility of such damages, or for any
  168. claim by any other party.
  169.  
  170. PERMISSION TO COPY:
  171.  
  172. Clubs and other non-profit organizations are granted permission by the
  173. author to freely copy these programs and documentation and share it with
  174. their members, so long as:
  175.  
  176. 1.  No price is charged for the software or documentation.  However, a
  177.     distribution cost may be charged for the cost of the diskette, so long
  178.     as it is not more than $10 total.
  179.  
  180. 2.  Club members are informed of the user-supported concept and encouraged
  181.     to support it with their donations.
  182.  
  183. 3.  The program or documentation are not modified in any way and are
  184.     distributed together.
  185.  
  186.  
  187. THE USER-SUPPORTED CONCEPT.
  188.  
  189.                         User-Supported Software
  190.        If you are using this program and find it to be of value
  191.                 your contribution will be appreciated.
  192.                           ($15 is suggested)
  193.  
  194.                             Alan Jones
  195.                          3717 Wildwood Drive
  196.                           Endwell, NY 13760
  197.  
  198.             Regardless of whether you make a contribution,
  199.           you are encouraged to copy and share this program.
  200.  
  201.  
  202.  
  203. User-supported software is an experiment in distributing computer
  204. programs, based on these beliefs:
  205.  
  206. 1.  That the value and utility of software is best assessed by the
  207.     user on his/her own system.
  208.  
  209. 2.  That the creation of personal computer software can and should
  210.     be supported by the computing community.
  211.  
  212. 3.  That copying of programs should be encouraged, rather than
  213.     restricted.
  214.  
  215. Anyone may request a copy of a user-supported program by sending a blank,
  216. formatted disk to the author of the program.  An addressed, postage-paid
  217. return mailer must accompany the disk (no exceptions, please).  A copy of
  218. the program, with documentation on the disk, will be sent by return mail.
  219. The program will carry a notice suggesting a contribution to the program's
  220. author.  Making a contribution is completely voluntary on the part of each
  221. user.
  222.  
  223. Free distribution of software and voluntary payment for its use eliminates
  224. costs for advertising and copy protection schemes.
  225.  
  226. Users obtain quality software at reduced cost.  They can try it out before
  227. buying, and do so at their own pace and in the comfort of their own home or
  228. office.  The best programs will survive, based purely on their quality and
  229. usefulness.
  230.  
  231. Please join the experiment.
  232.  
  233. If you believe in these ideals, your contribution is solicited to help make
  234. them work.
  235.  
  236. Many of you have written requesting an invoice so that you could initiate
  237. payment through your company accounting system.  The following invoice is
  238. provided for those of you in this category, or for those who wish an
  239. invoice for your tax records.  Perhaps it will serve the purpose.
  240.  
  241.  
  242.  
  243.                        --------------------
  244.                               INVOICE
  245.                        --------------------
  246.  
  247.  
  248.  
  249.  
  250.    Purchased from:
  251.        ALAN JONES
  252.        3717 Wildwood Drive
  253.        Endwell, NY 13760
  254.  
  255.  
  256.   DATE:     /     /                           Invoice No. 314159
  257.   --------------------------------------------------------------
  258.                                        PRICE     PRICE
  259.   PRODUCT                    QTY       EACH      EXTENDED
  260.   -------------------------  ---       -----     --------
  261.  
  262.   SP: A Print Spooler
  263.     program and
  264.     documentation             1         $15         $15
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                                       SALES TAX      0
  272.  
  273.                           --------------------------------------
  274.                           PLEASE PAY THIS AMOUNT    $15    TOTAL
  275.   --------------------------------------------------------------
  276.  
  277.  
  278.  
  279. Please make check payable to :ALAN JONES
  280.  
  281.  
  282. You may retain this Invoice
  283. for your tax records.
  284.  
  285.  
  286.